package com.ruoyi.system.mapper;


import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.system.domain.UserAdditionalInfo;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 小程序用户额外信息Mapper接口
 * 
 * @author chen
 * @date 2025-06-10
 */
public interface UserAdditionalInfoMapper extends BaseMapper<UserAdditionalInfo> {
    /**
     * 查询小程序用户额外信息
     * 
     * @param id 小程序用户额外信息主键
     * @return 小程序用户额外信息
     */
    public UserAdditionalInfo selectUserAdditionalInfoById(Long id);

    /**
     * 根据用户ID查询小程序用户额外信息
     *
     * @param userId 用户ID
     * @return 小程序用户额外信息
     */
    public UserAdditionalInfo selectUserAdditionalInfoByUserId(Long userId);

    /**
     * 查询小程序用户额外信息列表
     * 
     * @param userAdditionalInfo 小程序用户额外信息
     * @return 小程序用户额外信息集合
     */
    public List<UserAdditionalInfo> selectUserAdditionalInfoList(UserAdditionalInfo userAdditionalInfo);

    /**
     * 新增小程序用户额外信息
     *
     * @param userAdditionalInfo 小程序用户额外信息
     * @return 结果
     */
    public int insertUserAdditionalInfo(UserAdditionalInfo userAdditionalInfo);

    /**
     * 修改小程序用户额外信息
     * 
     * @param userAdditionalInfo 小程序用户额外信息
     * @return 结果
     */
    public int updateUserAdditionalInfo(UserAdditionalInfo userAdditionalInfo);

    /**
     * 删除小程序用户额外信息
     * 
     * @param id 小程序用户额外信息主键
     * @return 结果
     */
    public int deleteUserAdditionalInfoById(Long id);

    /**
     * 批量删除小程序用户额外信息
     * 
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteUserAdditionalInfoByIds(Long[] ids);

    /**
     * 行锁查询用户当前积分
     */
    Long selectCurrentPointsForUpdate(@Param("userId") Long userId);

    /**
     * 原子更新用户积分
     */
    int updateUserPoints(@Param("userId") Long userId,
                         @Param("pointsChange") Long pointsChange,
                         @Param("affectTotal") Boolean affectTotal);

    /**
     * 查询用户积分排行
     *
     * @param userAdditionalInfo 小程序用户额外信息
     * @return 小程序用户额外信息集合
     */
    List<UserAdditionalInfo> selectUserPointsRank(UserAdditionalInfo userAdditionalInfo);
}
